<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>gimpedit: GIMP 3 Library Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GIMP 3 Library Reference Manual">
<link rel="up" href="libgimp-image.html" title="Manipulating Images and their Properties">
<link rel="prev" href="libgimp3-gimpdrawableedit.html" title="gimpdrawableedit">
<link rel="next" href="libgimp3-gimpfile.html" title="gimpfile">
<meta name="generator" content="GTK-Doc V1.33.0 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
                  <a href="#libgimp3-gimpedit.description" class="shortcut">Description</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="libgimp-image.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="libgimp3-gimpdrawableedit.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="libgimp3-gimpfile.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="libgimp3-gimpedit"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="libgimp3-gimpedit.top_of_page"></a>gimpedit</span></h2>
<p>gimpedit — Edit menu functions (cut, copy, paste, clear, etc.)</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="libgimp3-gimpedit.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_proto_type">
<col class="functions_proto_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="libgimp3-gimpedit.html#gimp-edit-cut" title="gimp_edit_cut ()">gimp_edit_cut</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="libgimp3-gimpedit.html#gimp-edit-copy" title="gimp_edit_copy ()">gimp_edit_copy</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="libgimp3-gimpedit.html#gimp-edit-copy-visible" title="gimp_edit_copy_visible ()">gimp_edit_copy_visible</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GimpLayer.html" title="gimplayer"><span class="returnvalue">GimpLayer</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimp3-gimpedit.html#gimp-edit-paste" title="gimp_edit_paste ()">gimp_edit_paste</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GimpImage.html" title="gimpimage"><span class="returnvalue">GimpImage</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimp3-gimpedit.html#gimp-edit-paste-as-new-image" title="gimp_edit_paste_as_new_image ()">gimp_edit_paste_as_new_image</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="libgimp3-gimpedit.html#gimp-edit-named-cut" title="gimp_edit_named_cut ()">gimp_edit_named_cut</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="libgimp3-gimpedit.html#gimp-edit-named-copy" title="gimp_edit_named_copy ()">gimp_edit_named_copy</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="libgimp3-gimpedit.html#gimp-edit-named-copy-visible" title="gimp_edit_named_copy_visible ()">gimp_edit_named_copy_visible</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GimpLayer.html" title="gimplayer"><span class="returnvalue">GimpLayer</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimp3-gimpedit.html#gimp-edit-named-paste" title="gimp_edit_named_paste ()">gimp_edit_named_paste</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GimpImage.html" title="gimpimage"><span class="returnvalue">GimpImage</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimp3-gimpedit.html#gimp-edit-named-paste-as-new-image" title="gimp_edit_named_paste_as_new_image ()">gimp_edit_named_paste_as_new_image</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="libgimp3-gimpedit.description"></a><h2>Description</h2>
<p>Edit menu functions (cut, copy, paste, clear, etc.)</p>
</div>
<div class="refsect1">
<a name="libgimp3-gimpedit.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gimp-edit-cut"></a><h3>gimp_edit_cut ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_edit_cut (<em class="parameter"><code><span class="type">gint</span> num_drawables</code></em>,
               <em class="parameter"><code>const <a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> **drawables</code></em>);</pre>
<p>Cut from the specified drawables.</p>
<p>If there is a selection in the image, then the area specified by the
selection is cut from the specified drawables and placed in an
internal GIMP edit buffer. It can subsequently be retrieved using
the <a class="link" href="libgimp3-gimpedit.html#gimp-edit-paste" title="gimp_edit_paste ()"><code class="function">gimp_edit_paste()</code></a> command. If there is no selection and only one
specified drawable, then the specified drawable will be removed and
its contents stored in the internal GIMP edit buffer. This procedure
will fail if the selected area lies completely outside the bounds of
the current drawables and there is nothing to cut from.</p>
<div class="refsect3">
<a name="gimp-edit-cut.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>num_drawables</p></td>
<td class="parameter_description"><p>The number of drawables.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>drawables</p></td>
<td class="parameter_description"><p>The drawables to cut from. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_drawables][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GimpItem]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-edit-cut.returns"></a><h4>Returns</h4>
<p> TRUE if the cut was successful, FALSE if there was nothing to copy from.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-edit-copy"></a><h3>gimp_edit_copy ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_edit_copy (<em class="parameter"><code><span class="type">gint</span> num_drawables</code></em>,
                <em class="parameter"><code>const <a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> **drawables</code></em>);</pre>
<p>Copy from the specified drawables.</p>
<p>If there is a selection in the image, then the area specified by the
selection is copied from the specified drawables and placed in an
internal GIMP edit buffer. It can subsequently be retrieved using
the <a class="link" href="libgimp3-gimpedit.html#gimp-edit-paste" title="gimp_edit_paste ()"><code class="function">gimp_edit_paste()</code></a> command. If there is no selection, then the
specified drawables' contents will be stored in the internal GIMP
edit buffer. This procedure will fail if the selected area lies
completely outside the bounds of the current drawables and there is
nothing to copy from. All the drawables must belong to the same
image.</p>
<div class="refsect3">
<a name="gimp-edit-copy.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>num_drawables</p></td>
<td class="parameter_description"><p>The number of drawables to save.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>drawables</p></td>
<td class="parameter_description"><p>Drawables to copy from. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_drawables][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GimpItem]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-edit-copy.returns"></a><h4>Returns</h4>
<p> TRUE if the cut was successful, FALSE if there was nothing to copy from.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-edit-copy-visible"></a><h3>gimp_edit_copy_visible ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_edit_copy_visible (<em class="parameter"><code><a class="link" href="GimpImage.html" title="gimpimage"><span class="type">GimpImage</span></a> *image</code></em>);</pre>
<p>Copy from the projection.</p>
<p>If there is a selection in the image, then the area specified by the
selection is copied from the projection and placed in an internal
GIMP edit buffer. It can subsequently be retrieved using the
<a class="link" href="libgimp3-gimpedit.html#gimp-edit-paste" title="gimp_edit_paste ()"><code class="function">gimp_edit_paste()</code></a> command. If there is no selection, then the
projection's contents will be stored in the internal GIMP edit
buffer.</p>
<div class="refsect3">
<a name="gimp-edit-copy-visible.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>image</p></td>
<td class="parameter_description"><p>The image to copy from.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-edit-copy-visible.returns"></a><h4>Returns</h4>
<p> TRUE if the copy was successful.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-2.html#api-index-2.2">2.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-edit-paste"></a><h3>gimp_edit_paste ()</h3>
<pre class="programlisting"><a class="link" href="GimpLayer.html" title="gimplayer"><span class="returnvalue">GimpLayer</span></a> *
gimp_edit_paste (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>,
                 <em class="parameter"><code><span class="type">gboolean</span> paste_into</code></em>);</pre>
<p>Paste buffer to the specified drawable.</p>
<p>This procedure pastes a copy of the internal GIMP edit buffer to the
specified drawable. The GIMP edit buffer will be empty unless a call
was previously made to either <a class="link" href="libgimp3-gimpedit.html#gimp-edit-cut" title="gimp_edit_cut ()"><code class="function">gimp_edit_cut()</code></a> or <a class="link" href="libgimp3-gimpedit.html#gimp-edit-copy" title="gimp_edit_copy ()"><code class="function">gimp_edit_copy()</code></a>.
The \"paste_into\" option specifies whether to clear the current
image selection, or to paste the buffer \"behind\" the selection.
This allows the selection to act as a mask for the pasted buffer.
Anywhere that the selection mask is non-zero, the pasted buffer will
show through. The pasted buffer will be a new layer in the image
which is designated as the image floating selection. If the image
has a floating selection at the time of pasting, the old floating
selection will be anchored to its drawable before the new floating
selection is added. This procedure returns the new floating layer.
The resulting floating selection will already be attached to the
specified drawable, and a subsequent call to floating_sel_attach is
not needed.</p>
<div class="refsect3">
<a name="gimp-edit-paste.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable to paste to.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>paste_into</p></td>
<td class="parameter_description"><p>Clear selection, or paste behind it?</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-edit-paste.returns"></a><h4>Returns</h4>
<p>The new floating selection. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-edit-paste-as-new-image"></a><h3>gimp_edit_paste_as_new_image ()</h3>
<pre class="programlisting"><a class="link" href="GimpImage.html" title="gimpimage"><span class="returnvalue">GimpImage</span></a> *
gimp_edit_paste_as_new_image (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Paste buffer to a new image.</p>
<p>This procedure pastes a copy of the internal GIMP edit buffer to a
new image. The GIMP edit buffer will be empty unless a call was
previously made to either <a class="link" href="libgimp3-gimpedit.html#gimp-edit-cut" title="gimp_edit_cut ()"><code class="function">gimp_edit_cut()</code></a> or <a class="link" href="libgimp3-gimpedit.html#gimp-edit-copy" title="gimp_edit_copy ()"><code class="function">gimp_edit_copy()</code></a>. This
procedure returns the new image or -1 if the edit buffer was empty.</p>
<div class="refsect3">
<a name="gimp-edit-paste-as-new-image.returns"></a><h4>Returns</h4>
<p>The new image. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-edit-named-cut"></a><h3>gimp_edit_named_cut ()</h3>
<pre class="programlisting"><span class="returnvalue">gchar</span> *
gimp_edit_named_cut (<em class="parameter"><code><span class="type">gint</span> num_drawables</code></em>,
                     <em class="parameter"><code>const <a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> **drawables</code></em>,
                     <em class="parameter"><code>const <span class="type">gchar</span> *buffer_name</code></em>);</pre>
<p>Cut into a named buffer.</p>
<p>This procedure works like <a class="link" href="libgimp3-gimpedit.html#gimp-edit-cut" title="gimp_edit_cut ()"><code class="function">gimp_edit_cut()</code></a>, but additionally stores
the cut buffer into a named buffer that will stay available for
later pasting, regardless of any intermediate copy or cut
operations.</p>
<div class="refsect3">
<a name="gimp-edit-named-cut.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>num_drawables</p></td>
<td class="parameter_description"><p>The number of drawables.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>drawables</p></td>
<td class="parameter_description"><p>The drawables to cut from. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_drawables][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GimpItem]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>buffer_name</p></td>
<td class="parameter_description"><p>The name of the buffer to create.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-edit-named-cut.returns"></a><h4>Returns</h4>
<p>The real name given to the buffer, or NULL if the cut failed.
The returned value must be freed with <code class="function">g_free()</code>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-edit-named-copy"></a><h3>gimp_edit_named_copy ()</h3>
<pre class="programlisting"><span class="returnvalue">gchar</span> *
gimp_edit_named_copy (<em class="parameter"><code><span class="type">gint</span> num_drawables</code></em>,
                      <em class="parameter"><code>const <a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> **drawables</code></em>,
                      <em class="parameter"><code>const <span class="type">gchar</span> *buffer_name</code></em>);</pre>
<p>Copy into a named buffer.</p>
<p>This procedure works like <a class="link" href="libgimp3-gimpedit.html#gimp-edit-copy" title="gimp_edit_copy ()"><code class="function">gimp_edit_copy()</code></a>, but additionally stores
the copied buffer into a named buffer that will stay available for
later pasting, regardless of any intermediate copy or cut
operations.</p>
<div class="refsect3">
<a name="gimp-edit-named-copy.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>num_drawables</p></td>
<td class="parameter_description"><p>The number of drawables.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>drawables</p></td>
<td class="parameter_description"><p>The drawables to copy from. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_drawables][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GimpItem]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>buffer_name</p></td>
<td class="parameter_description"><p>The name of the buffer to create.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-edit-named-copy.returns"></a><h4>Returns</h4>
<p>The real name given to the buffer, or NULL if the copy failed.
The returned value must be freed with <code class="function">g_free()</code>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-edit-named-copy-visible"></a><h3>gimp_edit_named_copy_visible ()</h3>
<pre class="programlisting"><span class="returnvalue">gchar</span> *
gimp_edit_named_copy_visible (<em class="parameter"><code><a class="link" href="GimpImage.html" title="gimpimage"><span class="type">GimpImage</span></a> *image</code></em>,
                              <em class="parameter"><code>const <span class="type">gchar</span> *buffer_name</code></em>);</pre>
<p>Copy from the projection into a named buffer.</p>
<p>This procedure works like <a class="link" href="libgimp3-gimpedit.html#gimp-edit-copy-visible" title="gimp_edit_copy_visible ()"><code class="function">gimp_edit_copy_visible()</code></a>, but additionally
stores the copied buffer into a named buffer that will stay
available for later pasting, regardless of any intermediate copy or
cut operations.</p>
<div class="refsect3">
<a name="gimp-edit-named-copy-visible.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>image</p></td>
<td class="parameter_description"><p>The image to copy from.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>buffer_name</p></td>
<td class="parameter_description"><p>The name of the buffer to create.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-edit-named-copy-visible.returns"></a><h4>Returns</h4>
<p>The real name given to the buffer, or NULL if the copy failed.
The returned value must be freed with <code class="function">g_free()</code>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-edit-named-paste"></a><h3>gimp_edit_named_paste ()</h3>
<pre class="programlisting"><a class="link" href="GimpLayer.html" title="gimplayer"><span class="returnvalue">GimpLayer</span></a> *
gimp_edit_named_paste (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>,
                       <em class="parameter"><code>const <span class="type">gchar</span> *buffer_name</code></em>,
                       <em class="parameter"><code><span class="type">gboolean</span> paste_into</code></em>);</pre>
<p>Paste named buffer to the specified drawable.</p>
<p>This procedure works like <a class="link" href="libgimp3-gimpedit.html#gimp-edit-paste" title="gimp_edit_paste ()"><code class="function">gimp_edit_paste()</code></a> but pastes a named
buffer instead of the global buffer.</p>
<div class="refsect3">
<a name="gimp-edit-named-paste.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable to paste to.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>buffer_name</p></td>
<td class="parameter_description"><p>The name of the buffer to paste.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>paste_into</p></td>
<td class="parameter_description"><p>Clear selection, or paste behind it?</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-edit-named-paste.returns"></a><h4>Returns</h4>
<p>The new floating selection. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-edit-named-paste-as-new-image"></a><h3>gimp_edit_named_paste_as_new_image ()</h3>
<pre class="programlisting"><a class="link" href="GimpImage.html" title="gimpimage"><span class="returnvalue">GimpImage</span></a> *
gimp_edit_named_paste_as_new_image (<em class="parameter"><code>const <span class="type">gchar</span> *buffer_name</code></em>);</pre>
<p>Paste named buffer to a new image.</p>
<p>This procedure works like <a class="link" href="libgimp3-gimpedit.html#gimp-edit-paste-as-new-image" title="gimp_edit_paste_as_new_image ()"><code class="function">gimp_edit_paste_as_new_image()</code></a> but pastes
a named buffer instead of the global buffer.</p>
<div class="refsect3">
<a name="gimp-edit-named-paste-as-new-image.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>buffer_name</p></td>
<td class="parameter_description"><p>The name of the buffer to paste.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-edit-named-paste-as-new-image.returns"></a><h4>Returns</h4>
<p>The new image. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.33.0</div>
</body>
</html>